2.4 使用 ClaudeCodeRouter 工具

ClaudeCodeRouter 是一个便捷的工具，可以让你在不同的大模型之间快速切换，无需每次都去设置中修改配置。

什么是 ClaudeCodeRouter#

ClaudeCodeRouter 是一个模型路由工具，它的主要功能包括：

集中管理多个 AI 模型的配置
内置模型适配器，可以把GPT类的模型也作为Claude Code的驱动模型
一键切换不同的模型
根据任务类型自动选择合适的模型
显示各模型的使用统计信息

简单来说，它就像一个"模型切换器"，让你在使用 Claude Code 时可以随时GLM、GPT、Qwen等模型之间切换。

安装与配置#

步骤 1：安装 ClaudeCodeRouter#

ClaudeCodeRouter 通常以 npm 包的形式提供。

打开终端（命令行）

输入以下命令安装：


bash
npm install -g @musistudio/claude-code-router

等待安装完成

步骤 2：配置模型信息#

在终端中输入：
```
bash
ccr ui
```

这会打开一个图形化界面，帮助你配置模型信息。

按照提示添加和配置你想要使用的模型。配置过程可能有点枯燥，你需要研究它的适配器是怎么工作的。
保存配置并重启

步骤 3：在 Claude Code 中接入 ClaudeCodeRouter#

在 Claude Code 的 settings.json 配置文件中，修改 env 的信息。


json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "123456",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

其中 http://127.0.0.1:3456 是 ClaudeCodeRouter 提供的服务地址。Claude Code届时会将所有请求发送到这个地址，由 ClaudeCodeRouter 路由到不同的模型。

随时随地切换大模型#

通过 ccr ui 命令打开管理界面，你可以在界面中查看和切换不同的模型。在每次调整完配置之后，一定要记住点击“保存并重启”，否则Claude Code无法使用最新配置。

常见问题#

Q：ClaudeCodeRouter 是免费的吗？ A：ClaudeCodeRouter 工具本身是免费的，但使用各个模型仍需支付相应的 API 费用。

Q：可以同时配置多个国内模型吗？ A：可以，你可以配置GLM、通义千问等多个国内模型，随时切换使用。

Q：切换模型会影响对话历史吗？ A：不会，对话历史会保留，但不同模型可能对上下文的理解略有差异。

Claude Code 深度教程